Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊
This playbook is triggered automatically when an IP entity is detected in a Microsoft Sentinel incident, based on an automation rule. Upon triggering, it extracts the IP address from the entity and queries the Censys API (v3) to retrieve detailed host information including geolocation (continent, country, city, coordinates), autonomous system details (ASN, BGP prefix), WHOIS data (network, organization, contacts), services, and DNS information. The playbook retrieves the Censys API token securel
| Attribute | Value |
|---|---|
| Type | Playbook |
| Solution | Censys |
| Source | View on GitHub |
This playbook uses 5 Logic App connectors / built-in actions:
| Connector / Action | Type | Connections | Actions |
|---|---|---|---|
azureloganalyticsdatacollector |
Managed | 1 | 1 |
azuresentinel |
Managed | 1 | 1 |
keyvault |
Managed | 1 | 1 |
http |
Built-in | 0 | 2 |
workflow |
Built-in | 0 | 1 |
azureloganalyticsdatacollector (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Ingest_Censys_Host_Data | post | /api/logs |
— |
azuresentinel (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Get_incident | post | /Incidents |
— |
keyvault (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Get_Censys_API_Token | get | /secrets/@{encodeURIComponent('Censys-Access-Token')}/value |
— |
http (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| HTTP_Call_to_Fetch_Host_Enrichment_Data | GET | @{variables('base_url')}/@{variables('api_version')}/global/asset/enrichment/host/@{encodeURIComponent(variables('EntityData'))} |
— |
| HTTP_Call_to_Fetch_Host_Data | GET | @{variables('base_url')}/@{variables('api_version')}/global/asset/host/@{variables('EntityData')} |
— |
workflow (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| CensysIncidentEnrichment | — | — | workflowId=[concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Logic/workflows/',trim(parameters('IncidentEnrichmentPlaybookName')))]triggerName= When_an_HTTP_request_is_received |
📄 Source: CensysEntityEnrichmentHost/readme.md
This playbook is triggered automatically when an IP entity is detected in a Microsoft Sentinel incident, based on an automation rule. Upon triggering, it extracts the IP address from the entity and queries the Censys API (v3) to retrieve detailed host information including geolocation (continent, country, city, coordinates), autonomous system details (ASN, BGP prefix), WHOIS data (network, organization, contacts), services, and DNS information. The playbook retrieves the Censys API token securely from Azure Key Vault, performs the API call with retry logic (up to 3 attempts) and comprehensive error handling for HTTP status codes (200, 401, 403, 404, 422). Upon successful data retrieval, the host data is ingested into Azure Log Analytics (CensysHost_CL table) for historical analysis and reporting. The playbook then retrieves the associated incident and invokes the CensysIncidentEnrichment sub-playbook to add the enrichment data as a comment to the incident. If no incident is associated, the playbook terminates successfully after data ingestion.
By default this playbook first queries the Censys Host Enrichment API (v3/global/asset/enrichment/host), which returns the standard host record plus GreyNoise, IPinfo (network and privacy) and Mallory third-party data. The enrichment API is a separately entitled feature: if it responds with 403 (not entitled) or 409, or with any other non-success status, the playbook falls back to the standard host API so that enrichment still completes. A 401 response terminates the run with an authentication error pointing at the Key Vault secret and Organization ID. Set the UseHostEnrichment parameter to false to always use the standard host API.
Once deployment is complete, authorize each connection.
Grant the playbook's managed identity 'Key Vault Secrets User' role on the Azure Key Vault.
Create an automation rule in Microsoft Sentinel to trigger this playbook for IP entities.
Ensure the CensysIncidentEnrichment (or CensysAddIncidentComment) playbook is deployed and accessible.
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊